Call Progress Tones File
The Call Progress Tones (CPT) file contains definitions of the CPT (levels and frequencies) that are detected and generated by the device.
You can use one of the supplied Auxiliary files (.dat file format) or create your own file. To create your own file, it's recommended to modify the supplied usa_tone.ini file (in any standard text editor) to suit your specific requirements and then convert the modified ini file into binary dat file format, using AudioCodes DConvert utility. For more information, refer to the document DConvert Utility User's Guide.
The CPT file can only be loaded in .dat file format.
You can create up to 32 different Call Progress Tones, each with frequency and format attributes. The frequency attribute can be single or dual-frequency (in the range of 300 to 1980 Hz) or an Amplitude Modulated (AM). Up to 64 different frequencies are supported. Only eight AM tones, in the range of 1 to 128 kHz, can be configured (the detection range is limited to 1 to 50 kHz). Note that when a tone is composed of a single frequency, the second frequency field must be set to zero.
The format attribute can be one of the following:
|
■
|
Continuous: A steady non-interrupted sound (e.g., a dial tone). Only the 'First Signal On time' should be specified. All other on and off periods must be set to zero. In this case, the parameter specifies the detection period. For example, if it equals 300, the tone is detected after 3 seconds (300 x 10 msec). The minimum detection time is 100 msec. |
|
■
|
Cadence: A repeating sequence of on and off sounds. Up to four different sets of on/off periods can be specified. |
|
■
|
Burst: A single sound followed by silence. Only the 'First Signal On time' and 'First Signal Off time' should be specified. All other on and off periods must be set to zero. The burst tone is detected after the off time is completed. |
You can specify several tones of the same type. These additional tones are used only for tone detection. Generation of a specific tone conforms to the first definition of the specific tone. For example, you can define an additional dial tone by appending the second dial tone's definition lines to the first tone definition in the ini file. The device reports dial tone detection if either of the two tones is detected.
The Call Progress Tones section of the ini file comprises the following segments:
|
■
|
[NUMBER OF CALL PROGRESS TONES]: Contains the following key:
'Number of Call Progress Tones' defining the number of Call Progress Tones that are defined in the file. |
|
■
|
[CALL PROGRESS TONE #X]: containing the Xth tone definition, starting from 0 and not exceeding the number of Call Progress Tones less 1 defined in the first section (e.g., if 10 tones, then it is 0 to 9), using the following keys: |
|
●
|
Tone Type: Call Progress Tone types: |
|
◆
|
[9] Call Waiting Tone - heard by called party
|
|
◆
|
[16] Off Hook Warning Tone
|
|
◆
|
[17] Call Waiting Ringback Tone (heard by the calling party) |
|
●
|
Tone Modulation Type: Amplitude Modulated (1) or regular (0) |
|
●
|
Tone Form: The tone's format can be one of the following: |
|
●
|
Low Freq [Hz]: Frequency (in Hz) of the lower tone component in case of dual frequency tone, or the frequency of the tone in case of single tone. This is not relevant to AM tones. |
|
●
|
High Freq [Hz: Frequency (in Hz) of the higher tone component in case of dual frequency tone, or zero (0) in case of single tone (not relevant to AM tones). |
|
●
|
Low Freq Level [-dBm]: Generation level 0 dBm to -31 dBm in dBm (not relevant to AM tones). |
|
●
|
High Freq Level: Generation level of 0 to -31 dBm. The value should be set to 32 in the case of a single tone (not relevant to AM tones). |
|
●
|
First Signal On Time [10 msec]: 'Signal On' period (in 10 msec units) for the first cadence on-off cycle. For continuous tones, the parameter defines the detection period. For burst tones, it defines the tone's duration. |
|
●
|
First Signal Off Time [10 msec]: 'Signal Off' period (in 10 msec units) for the first cadence on-off cycle (for cadence tones). For burst tones, the parameter defines the off time required after the burst tone ends and the tone detection is reported. For continuous tones, the parameter is ignored. |
|
●
|
Second Signal On Time [10 msec]: 'Signal On' period (in 10 msec units) for the second cadence on-off cycle. Can be omitted if there isn't a second cadence. |
|
●
|
Second Signal Off Time [10 msec]: 'Signal Off' period (in 10 msec units) for the second cadence on-off cycle. Can be omitted if there isn't a second cadence. |
|
●
|
Third Signal On Time [10 msec]: 'Signal On' period (in 10 msec units) for the third cadence on-off cycle. Can be omitted if there isn't a third cadence. |
|
●
|
Third Signal Off Time [10 msec]: 'Signal Off' period (in 10 msec units) for the third cadence on-off cycle. Can be omitted if there isn't a third cadence. |
|
●
|
Fourth Signal On Time [10 msec]: 'Signal On' period (in 10 msec units) for the fourth cadence on-off cycle. Can be omitted if there isn't a fourth cadence. |
|
●
|
Fourth Signal Off Time [10 msec]: 'Signal Off' period (in 10 msec units) for the fourth cadence on-off cycle. Can be omitted if there isn't a fourth cadence. |
|
●
|
Carrier Freq [Hz]: Frequency of the carrier signal for AM tones. |
|
●
|
Modulation Freq [Hz]: Frequency of the modulated signal for AM tones (valid range from 1 to 128 Hz). |
|
●
|
Signal Level [-dBm]: Level of the tone for AM tones. |
|
●
|
AM Factor [steps of 0.02]: Amplitude modulation factor (valid range from 1 to 50). Recommended values from 10 to 25. |
|
●
|
When the same frequency is used for a continuous tone and a cadence tone, the 'Signal On Time' parameter of the continuous tone must have a value that is greater than the 'Signal On Time' parameter of the cadence tone. Otherwise, the continuous tone is detected instead of the cadence tone. |
|
●
|
The tones frequency must differ by at least 40 Hz between defined tones. |
Below shows an example of a configured dial tone to 440 Hz only:
[NUMBER OF CALL PROGRESS TONES]
Number of Call Progress Tones=1
#Dial Tone
[CALL PROGRESS TONE #0]
Tone Type=1
Tone Form =1 (continuous)
Low Freq [Hz]=440
High Freq [Hz]=0
Low Freq Level [-dBm]=10 (-10 dBm)
High Freq Level [-dBm]=32 (use 32 only if a single tone is required)
First Signal On Time [10msec]=300; the dial tone is detected after 3 sec
First Signal Off Time [10msec]=0
Second Signal On Time [10msec]=0
Second Signal Off Time [10msec]=0
|
➢
|
To upload a Call Progress Tones file: |
|
2.
|
Under the Call Progress Tones file group, click the Choose File button (or Browse button, depending on browser) to select the file from a folder on your computer, and then click Load File: |
|
3.
|
Restart the device with a burn-to-flash for your settings to take effect. |
Uploading a CPT file requires a device restart. After you have uploaded the file, the Restart button on the toolbar appears with a red border, which you need to click.